home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / mus / play / AmigaAMP11.lha / AmigaAMP / AmigaAMP.readme < prev    next >
Text File  |  1998-03-06  |  11KB  |  282 lines
  1. Short:    MPEG audio player with GUI (68k/PPC)
  2. Uploader: Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  3. Author:   Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  4. Type:     mus/play
  5. Version:  1.1
  6.  
  7. New features
  8. ------------
  9.  - name changed to AmigaAMP
  10.  - PPC version
  11.  - ID3 tag editor
  12.  - commandline support
  13.  
  14. Introduction
  15. ------------
  16. AmigaAMP is a GUI based MPEG audio player using mpega.library on the 68k
  17. processor or the amp decoding engine in the PPC version.  Sound is played
  18. back using the AHI audio system.  AmigaAMP is NOT another frontend for the
  19. CLI based mpega.  Anyway, if you've got problems not related to the user
  20. interface but with AHI, AsyncIO or mpega.library, PLEASE contact the
  21. corresponding author directly.  I wouldn't be able to help you in this
  22. case.
  23.  
  24. Requirements (not included in this archive!)
  25. --------------------------------------------
  26. mpega.library    (Aminet:util/libs/mpega_library.lha)
  27. asyncio.library  (Aminet:dev/c/AsyncIO.lha)
  28. AHI audio system (Aminet:mus/misc/ahiusr.lha)
  29.  
  30. Features
  31. --------
  32.  - FREEWARE!  No beta, no nag requesters and no expiry date!
  33.  - GadTools based font sensitive user interface
  34.  - Workbench application (you can drop icons on its window)
  35.  - Easily configurable
  36.  - AHI device level access (uses default audio mode automatically)
  37.  - 680x0 AND PPC-version
  38.  - ID3 tag editor (artist, title, albm, etc.)
  39.  
  40. Limitations
  41. -----------
  42.  - The PPC version doesn't support MPEG2.5 yet, I'm working on it
  43.  - No realtime scopes yet
  44.  - No asynchronous GUI in the PPC version due to missing functions
  45.    in PowerUP
  46.  
  47. Getting started (configuration)
  48. -------------------------------
  49. Important! You need a properly installed and configured AHI audio system
  50. to run AmigaAMP. Without a correct setup the sound may be very poor!
  51.  
  52. First of all run the AHI setup program in your Prefs drawer. Select
  53. one of the units from 0 to 3 but not the Music unit. If you don't use
  54. unit 0 for anything already I recommend using that one.
  55.  
  56. Select one of the "fast stereo++" audiomodes that matches your audio
  57. hardware. For Prelude playback I recommend "Prelude:Fast 16 bit stereo++
  58. realtime".
  59.  
  60. Now you need to know what sampling rate most of your MPEG files
  61. have. Probably it's 44100 Hz because that's the standard CD rate. If
  62. you have a slow processor you may want to run AmigaAMP in frequency division
  63. mode to reduce CPU load. Have a look at the table below for the recommended
  64. settings.
  65.  
  66. It is important to set the frequency slider to your mostly used frequency
  67. divided by your chosen frequency divisor. For example, if you're going to
  68. playback lots of 44100 Hz MPEGs and frequency division is 1:2, set the
  69. Frequency slider to 22050 Hz.
  70.  
  71. If you don't plan to have several programs playing back audio at the
  72. same time, please leave the Channels slider at position 1. The remaining
  73. settings depend on your audio hardware.
  74.  
  75. Ok, press the "Save" button in the bottom left corner.
  76.  
  77. Now it's time to configure AmigaAMP itself. If you've chosen another
  78. AHI device than 0, you have to change the AHIUNIT tooltype of AmigaAMP
  79. first. If not, just start it by double clicking on its icon and pop up
  80. the setup window by chosing Config... from the menu.
  81.  
  82. Set the sliders and checkmarks to the recommended settings, save them using
  83. the menu and close the settings window again.
  84.  
  85. That's it! AmigaAMP is now configured. You may want to fine-tune the
  86. settings later. The overall performance depends on the speed of mpega.library
  87. AND the the speed of your soundcard's AHI driver.
  88.  
  89. Recommended settings (tested with Prelude:Fast 16 bit stereo++ realtime)
  90. ------------------------------------------------------------------------
  91.  
  92.           |     Layer 1/2        |        Layer 3
  93. Processor | Quality|FreqDiv|Mono | Quality|FreqDiv|Mono
  94. ----------+--------+-------+-----+--------+-------+-----
  95. 68040-40  |  high  |  1:2  | off | medium |  1:2  | on 
  96. 68060-50  |  high  |  1:1  | off |  high  |  1:1  | off
  97. PPC604e   |  high  |  1:1  | off |  high  |  1:1  | off
  98.  
  99. Note: In fact only the 68k version is affected by these settings.
  100.  
  101.  
  102. Usage (how to load and play sounds)
  103. -----------------------------------
  104. Most of the buttons should be self-explanatory because they can be found
  105. on almost every CD player or tapedeck. However, as a computer program,
  106. AmigaAMP is based on files, so there may be slight differences. The bottom
  107. line buttons from left to right are:
  108.  
  109.  - Eject      Stops playback, empties the current playlist and opens a
  110.               requester to select one or more files
  111.  - Skip back  Moves to the previous track in the playlist if there is one.
  112.  - Stop       Simply stops playback. (What else did you expect? :-)
  113.  - Play       Starts playback if there's at least one track in the current
  114.               playlist. If it's not, opens a requester to select tracks.
  115.  - Skip fwd   Moves to the next track in the playlist if there is one.
  116.  - Pause      Pauses playback at the current position
  117.  
  118. Just above the control button's there's a position slider. As you play
  119. a file, it's button moves from left to right to display the relative
  120. playback position within the current track. You can use the mouse to drag
  121. this slider to a new position.
  122.  
  123. Legal stuff
  124. -----------
  125. AmigaAMP is copyrighted freeware. It may be distributed freely as long as
  126. no modifications are made to the executable and this document. A nominal
  127. fee may be asked to cover distribution costs.
  128.  
  129. AmigaAMP may not be used for any commercial purposes or included with any
  130. commercial product without the written permission of the author. It may
  131. NOT be stored on ftp servers or websites that also hold commercial software
  132. products or drivers for commercial hardware. The only exception are servers
  133. of the Aminet archive.
  134.  
  135. No responsibilities are taken for damaged speakers, amplifiers, Amigas
  136. or any other components or data involved while using AmigaAMP.
  137.  
  138. Although I've done some beta testing I can't guarantee that AmigaAMP will
  139. not crash! If you find any bugs, let me know.
  140.  
  141. Here's the original amp.readme:
  142. -------------------------------
  143. amp MPEG audio decoder readme file (version 0.7.5)
  144. (C) Tomislav Uzelac  1996,1997
  145.  
  146. amp is free software and can be _used_ freely by anyone. If you want to
  147. do anything else with it, be sure to check the Legal section of this
  148. document for legal issues.
  149.  
  150. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  151. of this document.
  152.  
  153. 1. Introduction
  154. 2. Installation
  155. 3. Running
  156. 4. Feedback
  157. 5. Contributing
  158. 6. Legal
  159.  
  160.  
  161. 1. Introduction
  162.  
  163. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  164. putting together as a side project of the MPEG hardware design project at 
  165. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  166. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  167. defined in MPEG2), layers 2 and 3. 
  168.  
  169. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  170. available at the amp home site ftp://ftp.rasip.fer.hr
  171.  
  172. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  173.  
  174. The following people contributed their time and knowledge to amp:
  175. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  176. Edouard Lafargue, Andrew Richards, George Colouris,
  177. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  178.  
  179. amp home location is
  180.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  181.  
  182. and the mailing list: send 'HELP' in the body of the message to:
  183.     multimedia@rasip.fer.hr
  184.  
  185. If you want to find out more about MPEG, best places to start are
  186.     http://www.mpeg.org
  187.     http://www.mpeg2.de 
  188.  
  189.  
  190. 2. Installation
  191.  
  192. Installation should be simple enough if amp was ported to your system,
  193. just do a 
  194.  
  195. ./configure
  196. make 
  197.  
  198. You can edit the makefile further to suit your system. If configure fails 
  199. to make a usable Makefile, you'll _have_ to edit it yourself.
  200.  
  201. Linux users should try real-time playing support, as described
  202. in doc/realtime.txt. Some people that might pass on this feature are
  203. those with slower machines (i.e. 486's), or SMP systems (see the
  204. doc/linuxrealtime.txt file). 
  205. Some versions of the linux C library produce an error when compiling
  206. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  207. and replace _P in the offending line with __P.
  208.  
  209. ./configure --enable-realtime
  210. make
  211. chown root.root amp
  212. chmod u+s amp
  213.  
  214. ... this requires /dev/dsp to be both world readable and writeable. If you
  215. have a special group for people allowed to use the sound device (for
  216. instance, a group called sound), you can do a:
  217.  
  218. chmod g+s amp
  219.  
  220. or make your audio card world read/writeable (not recomended)
  221.  
  222. chmod o+rw /dev/dsp*
  223.  
  224. 3. Running:
  225.  
  226. 'amp -h' gives you usage & options. If your computer is on the slower
  227. side, direct playback might not work, but you can decode it
  228. to .wav or raw pcm and play it later.
  229.  
  230.  
  231. 4. Feedback
  232.  
  233. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  234. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  235.  
  236. If you find any mpeg audio files that amp has trouble decoding, please tell
  237. me about this via e-mail <tuzelac@rasip.fer.hr>.
  238.  
  239.  
  240. 5. Contributing
  241.  
  242. Please contribute to amp. If you want to know what is going on in amp 
  243. development, you can join the developers mailing list
  244.  
  245.     mpeg_audio_developers@rasip.fer.hr
  246.  
  247. There are certain debugging facilities that I made in amp, but are disabled
  248. in the current release (they are neither nice nor user-friendly). If anyone
  249. enhances them (they are in dump.c) to the point that they're actually
  250. usable I'll be happy to include the changes in the release. I think this
  251. kind of debug output would be very useful to people studying these audio
  252. algorithms.
  253.  
  254.  
  255. 6. Legal
  256.  
  257. This software can be used freely for any purpose. It can be distributed
  258. freely, as long as it is not sold commercially without permission from
  259. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  260. on CD_ROMs containing other free software is explicitly permitted even 
  261. when a modest distribution fee is charged for the CD, as long as this
  262. software is not a primary selling argument for the CD.
  263.  
  264. Building derived versions of this software is permitted, as long as they
  265. are not sold commercially without permission from Tomislav Uzelac 
  266. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  267. such, and must be called by a name other than amp. Any derived versions
  268. must retain this copyright notice.
  269.  
  270. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  271.  * not mention being copyrighted itself :)
  272.  */
  273.  
  274. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  275. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  276. any damages that might occur to your computer, software, etc. in
  277. consequence of you using this freeware program.
  278.  
  279.  
  280. Tomislav Uzelac
  281. <tuzelac@rasip.fer.hr>
  282.